home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 26.zip / BS1 part 26 / AMOS compiler.adf / Welcome.Asc < prev    next >
Text File  |  1991-08-14  |  7KB  |  196 lines
  1.      ____   ______ ______ ______ ______ __    __   ______ __    __ ______
  2.     / __ \ / ____// ____// ____// __  //  \  / /  / __  //  \  / // ____/
  3.    / /_/ // ____// ____// /___ / /_/ // /\ \/ /  / /_/ // /\ \/ // ____/
  4.   /_____//_____//_/    /_____//_____//_/  \__/  /_____//_/  \__//_____/ U.K.
  5.                                
  6.  
  7.                   **** Present the AMOS Compiler! ****
  8.  
  9.            Please read the important text at the end of this file!
  10.  
  11.  
  12.    Congratulations on buying the fantastic new AMOS Compiler! This latest
  13. addition to the AMOS family will allow your programs to run at lightening
  14. speed with the minimum of effort. If your Invaders from Mars need that extra
  15. bit of zest, the AMOS Compiler can give it to them! If your spreadsheet or
  16. utility needs that extra bit of processing power, the AMOS Compiler can
  17. handle it! It will turn your AMOS BASIC programs into Machine Code, 
  18. the language of the professionals.
  19.  
  20.    Before you begin, you'll need to update your AMOS system to Version 1.3.
  21. This new (and previously unavailable) version of AMOS includes many new
  22. commands and improvements over the previous version, and is supplied free of
  23. charge with the AMOS Compiler. All the new features are documented within
  24. this manual, together with the simple procedure to 'update to Version 1.3'.
  25.  
  26.    After you've done this, you'll only need to install the AMOS Compiler to
  27. be ready to go! The procedure to do this is quite simple and is detailed in
  28. the chapter 'Installing the Compiler'. A word of warning though, you must
  29. make sure that you are installing the correct version of the Compiler to
  30. suit your own system. If you don't do this, you may not be making the most
  31. of your systems capabilities.
  32.  
  33.    We hope that you enjoy using the AMOS Compiler! To really get the best
  34. out of it, you just need to use it.(and keep on using it!) In any case,
  35. please let us know how you've got on with the AMOS Compiler by sending in
  36. your creations. Who knows? You may soon have written the next best-selling
  37. arcade game!
  38.  
  39.    Another addition to the AMOS family is a spectacular graphical
  40. extravaganza - AMOS 3-D! Now you can create exciting 3-D games like
  41. Starglider II and Virus without complex programming or a degree in maths!
  42. Now create your own virtual reality with AMOS 3-D!
  43.  
  44.  
  45. ============================================================================
  46.  
  47.                     **** Extra (important!) information ****
  48.                 
  49.                 **** ONLY WITH THIS NEW / LATEST VERSION! ****
  50.  
  51. ============================================================================
  52.  
  53. (1) How to change that annoying flash!
  54.  
  55.    Many people have found the flashing sequence when you load a squashed 
  56. compiled program to be distasteful. Consequently, we have included an extra 
  57. option so that you can customise your own flashing sequence. This new option
  58. can be used in the same way as any other compiler option (for details, see
  59. Chapter 7.)
  60.  
  61. To use the new option, the program COMPILER.AMOS must be updated to include 
  62. one of the following options:
  63.  
  64.  
  65.    CFLASH$="-Z00" will flash colour 0 (the whole screen)
  66.  
  67.    CFLASH$="-Z01" will flash colour 1
  68.  
  69.    CFLASH$=" ?  " will flash the mouse pointer
  70.  
  71.    CFLASH$="-Z32" will not flash anything.
  72.    
  73.    CFLASH$="-Zxx" will flash colour xx.
  74.  
  75.    N.B. xx must be a two digit number, e.g.  legal 01 03 05 15 22
  76.                                                                      
  77. This new option should replace the old CFLASH$ command at the beginning of
  78. the COMPILER.AMOS program. Alternatively, the new "-Zxx" command can be used
  79. directly in the command line.
  80.  
  81.  
  82. (2) The use of VAL in a compiled program.
  83.  
  84.    When you compile a program which contains the instruction VAL, you must
  85. make sure that the compiler knows if the function is an integer or floating
  86. point number.
  87.  
  88.    In order to make it as simple for the user as possible, the following
  89. procedure is used:
  90.  
  91.     *  When compiling =VAL(Y), the compiler checks to see if a float
  92.        number has been previously used in the program. If it has, =VAL will
  93.        handle float numbers, otherwise it will just return integers, even
  94.        if your program uses float number AFTER the VAL function.
  95.  
  96.    A simple way of acheiving this goal is to simply include an instruction
  97. such as a#=0.0 at the beginning of a program, on the outside of any
  98. procedures. This will show the compiler that the program uses float numbers,
  99. and indirectly sets up the function VAL to handle floating point.
  100.  
  101. Note: sequential file inputting, internaly calls the VAL function. So you
  102. should ensure AMOS is in floatting point mode before attempt an input.
  103.  
  104.  
  105. (3) A few things about variables.
  106.  
  107.    The AMOS Compiler is a fast, one-pass compiler. However, because of its
  108. lightening compilation speed you MUST make sure GLOBAL variables are
  109. structured correctly:
  110.  
  111.    *  You cannot declare a GLOBAL variable (e.g. Global FOOL) after
  112.       assigning that variable a value (e.g. FOOL=56):
  113.  
  114.               FOOL = 56
  115.                            **** The incorrect way ****
  116.               Global FOOL
  117.  
  118.  
  119.    * You must declare a GLOBAL variable before assigning that variable a
  120.      value.
  121.  
  122.               Global FOOL
  123.                            **** The correct way ****
  124.               FOOL = 56
  125.  
  126.    You must use the same rule for DIMensioned variables by making
  127. sure that the GLOBAL command directly follows the DIM command, and not
  128. after you have assigned the string. If you follow these simple rules
  129. concerning GLOBAL variables you should have no trouble whatsoever with
  130. the AMOS Compiler.
  131.  
  132.  
  133. (4) Compiling VERY LARGE programs (125K+).
  134.  
  135.    We have tested the compiler with programs up to 125K of AMOS code. If you
  136. have written a larger program, you may encounter problems when compiling.
  137. The most common problem is that the compiler may (depending on your code
  138. structure) overwrite its own internal buffers. However, since it is very
  139. easy to alter the physical buffer set-up, any extra large programs can be
  140. compiled successfully. The procedure to do this is listed below:
  141.  
  142.    *  In AMOS direct mode, type:
  143.  
  144.       Rename ":AMOS_System/compiler_configuration" TO
  145.  
  146.              ":AMOS_System/compiler_configuration.old"
  147.  
  148.       Rename ":AMOS_System/compiler_configuration.large" TO
  149.  
  150.              ":AMOS_System/compiler_configuration"
  151.  
  152.  
  153.    This will double the size of the compiler's internal buffer, allowing the
  154. user to compile AMOS programs of upto 250K.
  155.  
  156.    *Another alternative for advanced users is to use a text editor to modify
  157. the buffer definition in the compiler_configuration file:
  158.  
  159.  
  160. (5) Serial Extension.
  161.  
  162.    A minor change in the documentation:
  163.  
  164.    - SERIAL BIT should read SERIAL BITS
  165.  
  166.    - SERIAL PARITY Channel,parity
  167.  
  168.    Parity can have 5 different states:
  169.  
  170.    -1 : no parity
  171.     0 : EVEN parity
  172.     1 : ODD parity
  173.     2 : SPACE parity
  174.     3 : MARK parity
  175.  
  176.  
  177.    This concludes the EXTRA information section. As long as you use the AMOS
  178.        Compiler with these simple rules in mind, you should have no problem!
  179.  
  180.    THIS FILE IS A DEFCON ONE RELEASE SUPPLIED BY THE ONE AND ONLY QUAZAR!!!
  181.    
  182.    PHONE THE DEFCON ONE U.K. H.Q. NOW FOR THE FAST WAREZZZZZZZZZZZZZZZZZZ
  183.   
  184.    THE NUMBER GAN BE GOT ON MOST GOOD BOARDS BUT ON MOST OF THE U.K. ONES...
  185.  
  186.  
  187.  L*RZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ         QUAZAR.
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.    
  195.  
  196.